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INTRODUCTION 

The DOS -Compatible Stand-alone Operating System (DSOS) can be used to perform 
all I/O device handling except disk I/O. I/O is performed on an interrupt driven 
basis, using core buffers unique to each declared device. 

Under DSOS channel numbers are fixed and always denote the same device/file. 
The DSOS channel number assigned to each device is as follows: 



Device 


Chanjiel Num.ber 


$PLT 


6 


$TTP 


10 


$CDR 


11 


$TTO 


12 


$TTI 


13 


$LPT 


14 


$PTR 


15 


$PTP 


16 


$TTR 


17 



All of the devices listed above are supported by DSOS. Additional device drivers 
may be added by users following the procedure outlined in Appendix A 

DSOS is supplied to DGC customers as a library tape containing the relocatable bi- 
nary programs: 

v^L/i\ui\ v_«ira Ktiaaer uriver 

PLTDR Plotter Driver 

SOS Main Program of DSOS 

DSOSI DOS to SOS Interface Program 

DOS -Compatible SOS is loaded with the Extended Relocatable Loader, 091-000038. 
To load the main program of DSOS (SOS), . SOS must be declared an external nor- 
mal in a previously loaded program. The main program of DSOS supports all 
DGC system devices except the card reader and the plotter. To load the card 
reader driver, . CDRD must be declared an external normal; to load the plotter 
driver, . PLTD must be declared an external normal. 

The DOS to SOS interface program (DSOSI) permits users to call DSOS while using 
the EDS channel number scheme. Under DOS, files are assigned by file name to 
temporary channel numbers while under DSOS channel numbers always denote the 
same file or device and file names are not recognized. The DOS to SOS interface 
program is loaded by declaring . DSI as an external normal instead of , SOS. The 



I/O commands for this program are identical to the Disk Operating System (DOS) 
I/O commands as described in Chapter 4 of the DOS User's Manual, 093-000048. 
The legal channel numbers are 0-7 under DOS; the file names that are passed are 
used by DSOSI to derive SOS channel numbers. 

DSOS program commands are described in Chapter 1 . The properties of each 
DSOS device are given in Chapter 2 . Appendix A contains a detailed internal de- 
scription of DSOS which permits users to add their own device drivers. Appendix 
B contains ASCII listings of the DSOS System Parameter Tape and the DOS User 
Parameter Tape. 
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CHAPTER 1 
DSOS - PROGRAM COMMUNICATION 



The user cOiiMiiunicates with the DOS -Compatible Stand-alone Operating System through 
system command words assembled into his program. 

The command . SYSI must be issued before any other DSOS commands can be used. 
It clears all devices and allocates to DSOS additional memory for device buffers, etc. 
Memory allocation is only performed on the first . SYSI. Additional . SYSI commands 
can be given if the user wishes to clear devices. 

The format of the command is: 

•SYSI ;INITIALIZE DSOS 

normal return ;AC'S AND CARRY ARE PRESERVED 

There is no error return from a .SYSI command. 

SYSTEM COMMAND FORMAT 

After communication is intialized using the command .SYSI, all other commands 
have the general format; 



aommand 

error return ; STATUS IN AC2 

normal return jAC'S AND CARRY ARE PRESERVED 

The mnemonic . SYSTM and the command words are recognized as legal mnemonics 
by the DOC Relocatable Assembler. 

The mnemonic . SYSTM must immediately precede the command. Appearance of the 
mnemonic . SYSTM results in the assembly of a 

JSR@2 

instruction which allows system communication through the main system entry 
address stored in page zero. The system command word must be assembled as the 
word following the . SYSTM. 
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SYSTEM COMMAND FORMAT (Continued) 

Once system action is completed, normal return is made to the second instruction 
after the system command word. If an exceptional condition is detected, return is made 
to the first instruction following the system command word. 

System commands have the form either of a mnemonic or a mnemonic followed by a 
channel number: 

command or command n 

where n is a digit that represents the fixed I/O channel (device) number. 

When no I/O channel is needed in command execution, the command word appears 
alone in the instruction. If the command requires arguments, these are passed in 
the accumulators. 

One argument commonly passed in an accumulator is a byte pointer. A byte pointer 
contains the word address in bits 0-14, which contain or will receive the byte. Bit 15 
specifies which half (0 left, 1 right). Note that this is the reverse of the byte pointer 
as specified in "How to Use the NOVA Computers. " To use the subroutine shown on 
Page 2-21 of the manual, change the MOV 0,0, SZC instruction to a MOV 0,0, SNC 
instruction. 

The channel (device) number for any system command requiring a channel number 
can also be passed in AC2. Specifying octal 77 as the channel number in the instruction 
causes the system to use the number passed in AC2. For example, the following 
instructions specify a write to channel 16: 

LDA 2,C16 
. SYSTM 

. WRS CPU 

JSR EOF 



C16: 16 

STATUS ON RETURN FROM SYSTEM 

Status of the accumulators upon return from the system is as follows: 

If the system returns no information as a result of the call, the carry and all accumu- 
lators except ACS will be preserved. 
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S TATUS ON RETURN FROM SYSTEM (Continued) 

AC2 is used when an exceptional return is made to return a numeric error code. 
Error codes are listed by number at the end of this chapter and the applicable codes 
are listed for each command. 

AC3 is destroyed by . SYSTM (as it is a JSR). On return from the system, however. 
AC3 is loaded from the contents of memory location 00016. This location is defined 
as a permanent symbol by the DGC assembler and has the name USP (User Stack 
Pointer. ) A convenient method of saving AC3 is to store it in location 00016 
before issumg the . SYSTM. 

LIST OF COMMAND WORDS 

The command word nuiemonics are: 

. SYSI Initialize . DSOS devices. 

. OPEN Open a file. 

.CLOSE Close a file. 

. RESET Close all open files. 

• RDS Read sequential characters. 

. RDL Read sequential line. 

.WRS Write sequential characters. 

.WRL Write sequential line. 

. GCHAR Read a character from TTI. 

. PCHAR Write a character to the TTO. 

. MEM Determine available memory space. 

. MEMI Allocate an increment of memory. 

DSOS commands are a subset of DOS commands. All other DOS commands, including .RTN, 
result in return of the error code "ILLEGAL SYSTEM COMMAND" in AC2. 

INPUT/OUTPUT COMMANDS 

All I/O is handled by system I/O commands. These commands require a channel number 
to be given in the second field of the command word. If the channel number is 77, then 
AC2 must contain the desired channel number. The system provides two basic modes 
for reading and writing files. 

The first mode is the line mode, where data read or written is assumed to consist 
of ASCII character strings terminated by either carriage returns or form feeds. In this 
mode, the system handles all device dependent editing at the device driver level. For 
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INPUT/OUTPUT COMMANDS (Continued) 

example, line feeds are ignored on paper tape input devices and supplied after 
carriage returns to all paper tape output devices. Further, reading and writing 
require byte counts, since reading continues until a carriage return is read and writing 
proceeds until a carriage return is written. The line mode commands are . RDL and . WRL. 

The second mode is unedited sequential mode. In this mode, data is transmitted 
exactly as read from the file or device. No assumption is made by the system as 
to the nature of this information. Thus, this mode would always be used for processing 
binary files. This mode requires the user program to specify byte counts 

necessary to satisfy a particular read or write request. The sequential mode commands 
are . RDS and . WRS. 

Open a File (. OPEN) 

Before other I/O commands can be used, a device must be opened with the .OPEN 
command. This command results in the initialization of the control table for the 
device, the output of leader on paper tape devices, or a prompt message for input 
devices requiring user intervention. 

. SYSTM 

.OPEN n ;OPEN CHANNEL n 

error return 

normal return 

Possible errors resulting from the .OPEN command are: 

AC2 Mnemonic Meaning 

ERFNO Illegal channel number. 

Close a File (.CLOSE) 

After use, files may be closed to insure an orderly ending sequence. The format 
of the . CLOSE command is: 

. SYSTM 

. CLOSE n ;CLOSE CHANNEL n 

error return 

normal return 

Possible errors resulting from a .CLOSE command are: 
AC2 Mnemonic Meaning 

ERFNO Illegal channel number. 
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INPUT/OUTPUT COMMANDS (Continued) 
Close All Files (. RESET ) 

The command causes all currently open files to be closed. The format of the . RESET 
command is: 

. SYSTM 
.RESET 

ewor return 
normal return 

The error return from this command is never taken. 
Read a Line (. RDL ) 

The command causes an ASCII line, having even parity, to be read. AC0 must 
contain a byte pointer to the starting byte address within the user area into which the 
line will be read. 

Reading will terminate normally after transmitting either a carriage return or a 
form feed to the user. Reading will terminate abnormally after transmission of 
132 characters (decimal) without detecting a carriage return or a form feed upon 
detection of a parity error, or upon end of file. In all cases, the byte count read will 
be returned in ACl. If the read is terminated because of a parity error, the character 
havmg incorrect parity will be stored (high order bit zero) as the last character read. 
The byte pointer to the character can always be computed as: 

C(ACO)+ C(ACl) -1 * 

The format of the . RDL command is: 

. SYSTM 

• RDL n ;READ FROM CHANNEL n 

error return 
normal return 



C(x) means "the contents of x' 
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INPUT/OUTPUT COMMANDS (Continued) 

Read a Line (. RDL) ( Continued) 

Possible errors resulting from a . RDL command are: 

AC2 Mnemonic Meaning 






ERFNO 


3 


ERICD 


6 


EREOF 


22 


ERLLI 


24 


ERPAR 


Write a Line (.WRL) 





Illegal channel number. 

Illegal command for device. 

End of file. 

Line limit (132 characters) exceeded. 

Parity error. 



This command assumes an ASCII file. ACO must contain a byte pointer to the starting 
byte address within the user area from which characters will be read. 

Writing will terminate normally upon writing a null, a carriage return or a form feed, 

and abnormally after transmission of 132 (decimal) characters without detection of a carriage 

return, a null, or a form feed. In either case, ACl will contain, upon termination, 

the number of bytes read from the user area to complete the request. The termination 

of a write line on a null allows for formatting output without forcing a carriage return. 

The format of the . WRL command is: 

. SYSTM 

.WRL n ;WRITE TO CHANNEL n 

error return 

normal return 

Possible errors resulting from the .WRL command are: 

AC2 Mnemonic Meaning 

ERFNO Illegal channel number. 

3 ERICD Illegal command for device. 

22 ERLLI Line limit (132 characters) exceeded. 

Read Sequential (.RDS ) 

Sequential mode transmits data exactly as read from the file. ACO must contain a 
byte pointer to the starting byte address within the user area into which the data will be 
read and ACl must contain the number of bytes to be read. The format of the . RDS 
command is: 
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INPUT/OUTPUT COMMANDS (Continued) 
Read Sequential(. RDS ) (Continued) 

. SYSTM 

.RDS n ; READ FROM CHANNEL n 

evvoT return 
normal return 

i w Kj Lji»j.i,„ v.-Liuxo icouiLiiig liuiii a. . JMJD commana are: 

ACQ Mnemoni c Meaning 

ERFNO Illegal channel number. 

J liRlCD Illegal command for device. 

6 EREOF End of file. 

Upon an end of file, the partial count read will be returned in ACl. 

Write Sequential (. WRS ) 

This command transmits data exactly as read from the user area. ACO must contain 
a byte pointer to the starting byte address of the data within the user area and ACl 
must contain the number of bytes to be written. The format of the , WRS command is: 

. SYSTM 

• WRS n ; WRITE TO CHANNEL n 

error return 
nortnal return 

Possible errors resulting from a .WRS command are: 

AC2 Mnemonic Meaning 

ERFNO Illegal channel number. 

3 ERICD Illegal command for device. 

TYPEWRITER COMMANDS 

Buffered transfer of single characters between the teletypewriter and ACO is handled 
by the commands, . GCHAR and . PCHAR. No channel number is required for these 
commands, and the teletype is always considered "open" to them. 

Get a Character (.GCHAR ) 

This command returns a character typed from the teletypewriter in ACO. The character 
is right-adjusted in ACO with bits 0-8 cleared. No channel is required; the TTI 
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TYPEWRITER COMMANDS (Continued) 



Get a Character (. GCHAR) (continued) 



is always used as input for this command. The format of the . GCHAR command is: 

. SYSTM 
. GCHAR 

error return 
normal return 

No error return is possible from this command. 
Put a Character (. PCHAR ) 

This command transmits a character in AGO, bits 9-15, to the teletypewriter. No 
channel is required; the TTO is always used as output for this command. The format 
of the . PCHAR command is: 

.SYSTM 
.PCHAR 

error return 
normal return 

No error return is possible from this command. 
MEMORY COMMANDS 

Upon completion of a relocatable load, the DOS -Compatible Stand-alone Operating 
System resides in lower memory among various user or system programs comprising 
the load module. Memory then looks essentially as follows: 



user program 



DSOS 



system program 



user program 



top of memory 

HMA (highest memory address available) 

NMAX (first location available above 
the loaded programs) 



Bottom of memory 
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MEMORY COMMANDS (Continued) 

The highest memory address available (HMA) is usually the first word below the Binary 
Loader. If a user symbol table has been loaded at the high end of user memory, the 
high memory address will be the first word below the user symbol table. 

The . MEM command returns both the current value of NMAX and HMA. The . ME MI 
command allows the user to adjust the value of NMAX. 

Determine Available Memory (.MEM ) 

This command returns the current value of NMAX in ACl and the value of HMA in ACO. 
HMA may represent either the bottom of the Binary Loader or the end of the user 

symbol table. A SUB 1,0 instmrrinn Hpfprminpc thf^ limil- nf Tnom,-,i-i7 oT7-^iIoK1^ <-„ 

the user program. The format of the . MEM command is: 

. SYSTM 
.MEM 

error return 
normal return 

There are no error returns from this command. 
Change NMAX (. MEMI) 

This command allows the user to increase or decrease the value of NMAX. The 
increment or decrement (in two's complement) is passed in ACO. The command causes 
the value of NMAX to be updated in the User Status Table and the new NMAX to be 
returned in ACl. The format of the . MEMI command is: 

. SYSTM 
.MEMI 

error return 
normal return 

NMAX will not be changed if the new value of NMAX would be higher than HMA. No 
check is made as to whether or not the user decreases NMAX below its original value 
(as determined at relocatable load time). 

Whenever a user program requires memory space above the loaded program, a . MEMI 
should be executed first to allocate the number of words needed. The allocated memory 
space may be used by programs for buffers, user stacks, temporary storage, etc. 

There is one error resulting from a . MEMI command: 
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MEMORY COMMANDS (Continued) 
Change NMAX (. MEMI) (Continued) 
AC2 Mnemonic 



26 



ERMEM 



Meaning 

Attempt to allocate more memory 
than available. 



ERROR MESSAGES 



CODE 


MNEMONIC 


MEANING 


APPLICABLE COMMANDS 





ERFNO 


ILLEGAL CHANNEL 


.OPEN 


. RDS . WRS 






NUMBER 


. CLOSE 


.RDL .WRL 


2 


ERICM 


ILLEGAL SYSTEM 
COMMAND 


-- 




3 


ERICD 


ILLEGAL COMMAND 


.RDS 


.WRS 






FOR DEVICE 


.RDL 


.WRL 


6 


EREOF 


END OF FILE 


.RDS 


.RDL 


7 


ERRPR 


ATTEMPT TO READ A 


.RDS 


.RDL 



22 



ERLLI 



READ PROTECTED FILE 

LINE LIMIT EXCEEDED 
ON READ OR WRITE LINE 



RDL 



,WRL 



24 



ERPAR 



PARITY ERROR ON READ 

LINE 



.RDL 



26 



ERMEM 



ATTEMPT TO ALLOCATE 
MORE MEMORY THAN 
AVAILABLE 



.MEMI 
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CHAPTER 2 
DSOS DEVICE PROPERTIES 



This chapter describes the functions performed by the DSOS I/O cnrrimands as appliec 
to each of the devices supported by DGC. 

$PLT 



. OPEN command 
• CLOSE command 
. WRS command 
^ Wp^^, com^man'^ 

$TTP 

. OPEN command 
.CLOSE command 

. WRS command 
. WRL command 



$CDR 

. OPEN com_m_and 

.CLOSE command 
. RDS command 

. RDL command 



Device is initialized. 

Device is reinitialized after outstanding I/O is complete. 

The specified bytes are output to the device, unedited. 



±j.xCgax COniniaiid to this device 



Device is initialized; leader is punched. 

Device is reinitialized after outstanding 1/0 is complete; 

trailer is punched. 

The specified bytes are output to the device, unedited. 

The ASCII string is output to the device with rubout 

characters inserted after tabs, a line feed inserted 

after carriage return, and nulls inserted after form feeds. 



^^•^^^ iw i.iitj.uj.i^._.j, a. ^s^Kjiiijjt iiicaoci^c IS VVilLHill ailU a 

response is necessary for the program to continue. 

Device is reinitialized. 

The specified bytes are read into the user area from the 

device, unedited. 

The 80 character ASCII string is read into the user area 

from the device. The translation from Hollerith is 

performed in the card reader driver. A 12-11-0-1 

punch causes end of file. The byte count returned to the 

user reflects the last non-blank character on the card. 



$TTO 



. OPEN command 
. CLOSE command 
. WRS command 
. WRL command 



Device is initialized. 

Device is reinitialized after outstanding I/O is complete. 
The specified bytes are output to the device, unedited. 
The ASCII string is output to the device with simulated 
tabbing, a line feed inserted after carriage return, and nulls 
inserted after form feeds. 
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$TTI 



. OPEN command 
.CLOSE command 
. RDS command 

. RDL command 



Device is initialized. 
Device is reinitialized. 

The specified bytes are read into the user area from the 
device, unedited. 

The ASCII string is read into the user area from the de- 
vice. The input stream is echoed to the $TTO. A rubout 
character deletes the previous input character and causes 
a back arrow to be echoed. The shift L character causes 
the entire input string to be deleted. Line feeds are 
ignored. 



$LPT 

. OPEN command 
.CLOSE command 
.WRS command 
.WRL command 



Device is initialized. 

Device is reinitialized ; a form feed character is output. 

The specified' bytes are output to the device, unedited. 

The ASCII string is output to the device with simulated 

tabbing, and line feeds are inserted after carriage 

returns. 



$PTR 

, OPEN command 

. CLOSE command 
. RDS command 

. RDL command 



Device is initialized, a prompt message is written and a 

response is necessary for the program to continue. 

Device is reinitialized. 

The specified bytes are read into the user area from the 

device, unedited. 

The ASCII string is read into the user area from the 

device. Rubouts, line feeds, and nulls are ignored. 



$PTP 

. OPEN command 
. CLOSE command 

. WRS command 
. WRL command 



Device is initialized; leader is punched. 

Device is reinitialized after outstanding I/O is complete; 

trailer is punched. 

The specified bytes are output to the device, unedited. 

The ASCII string is output to the device with rubouts 

inserted after tabs, a line feed after a carriage return, 

and nulls after a form feed. 
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$TTR 



. OPEN command 

CLOSE command 
RDS command 

RDL command 



Device is initialized - a prompt message is written and a 

response is necessary for the program to continue. 

Device is reinitialized. 

The specified bytes are read into the user area from the 

device, unedited. 

The ASCII string is read into the user area from the 

device. Rubouts, line feeds, and nulls are ignored. 
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APPENDIX A 
ADDING DEVICE HANDLERS TO DSOS 



This appendix is intended to ease the task of adding a special device driver to the DSOS 
library. There are two levels of DSOS compatibility available to the user wrho is 
incorporating additional devices: 

^' -ii iCVCi Vv'uiCii permits scrvicuig oi an interrupt from one or more 
special devices, while selectively enabling interrupts from other 
devices. 

2. A level which permits complete control of the device via standard 
SOS commands. 

The complexity of the required user program increases with the level. Level 1 requires 
a Device Control Table (DCT) for each device and a Device Priority Table. Level 2 
requires a DCT, a Device Priority Table, and a Channel Number to Device Mao. Ali 
of these tables, as well as the associated driver code, may be assc.-.bled in one relo- 
catable binary program. This program may then be included in the relocatable load 
module along with the DSOS library. The DSOS Parameters and the DOS User Parameters 
may be included in the assembly to assure the proper definition of the required tables. 

The critical requirements for these levels are: 

Level 1 Provide a means of clearing the device on system initializations 
and resets and provide interrupt save storage compatible with 
DSOS irnplernentation. 

Level 2 In addition to the requirements of 1, provide a DSOS Channel Number 
to Device Control Table link and include the appropriate subset 
of I/O Dispatch routines: open, close, line, and sequential. 

If the tables are correctly defined in the user program, the main program of DSOS (SOS) 
will perform these critical functions, using the supplied information. 

No source level changes to the DSOS library rograms are necessary. The links to the 
user supplied tables currently exist in the DSOS main program in the form of unresolved 
external declarations. If these unresolved externals become resolved in the relocatable 
load module, then DSOS assumes the presence of an additional device or devices. The 
user must be careful, therefore.not to resolve these externals inadvertently with his 
own global symbols. 

The remainder of this appendix describes the mechanisms that may be used to achieve 
Level 1 or Level 2 DSOS compatibility with optional devices. 
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DEVICE CONTROL TA13LE (DCT) 

Each DSOS device requires a control table. Although some elements of the table may 
not be used by an added driver, tlic tabic must be dcllned exactly as in the loiiowing 
description, so that the critical elements reside at the correct displacements, 'ihis 
table requires 24 octal locations (displacements 0-23 from the DCT layout description 
in the DSOS Parameter Tape. ) These displacements and their meanings are as follows: 



Equivalence Displacement 
DCTCD 



Explanation 

The octal device code, 
into the table. 



Must be assembled 



1 



DCTMS 



The mask of all lower priority oevices (including 
this device). This mask is used to disable 
interrupts from all lower priority devices 
while processing an interrupt from this device. 
This mask should reflect the priorities 
established by the device priority table (sec 
page A-5. ) The mask bits are defined in the 
DSOS parameter tapes. Must be assembled 
into the table. 



DCTCH 



The device charactci-istics from the DOS 
User Parameter Tape. Must be assembled 
into the table. Not referenced for Level 
1 devices. 



DCTLK 



Thelink to the next priority device, a pomter 
to its control table. This word is initialized 
by a . SYSI. The priorities are established 
by DSOS table .OPPP. 



DCTIS 



DCTIL 



The address of the interrupt service routine. 
Must be assembled into the table. (See ESOS 
Interrupt Handling, page A-7. ) 

The interrupt frame links. Points to the device 
control table of the last internaptcd device. 
This word is maintained by the DSOS interrupt 
service routine. 



DCTDT 



The Command Dispatch Table address for this 
device. The Command Dispatch Tiible must 
be ordered in the following manner: 
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DEVICE CONTROL TABLE (DCT) (^Continued) 



(Continued) 



- open routine address 

1 - close routine address 

2 - read/write sequential routine address 

3 - read/write line routine address 



Any of the before mentioned functions that are 
illegal for a device should contain a -1 in 
their location. Must be assembled into the 
table; see Device Start, Stop, and Dispatch 
Routines. 



10 



11 



DCTST 



DCTSP 



DCTFL 



The address of the device start routine. Must 
be assembled into the table. (See Device 
Start, Stop, and Dispatch routines. ) 

The address of the device stop routine. Must 
be assembled into the table. (See Device 
Start, Stop, and Dispatch routines. ) 

The device flags. These flag bits are maintained 
by the global DSOS subroutines. Three flags are 
currently defined: 



DCACT = 1B15 - Device is active 

(executing I/O). Must 
be off to perform a DSOS 
reset. 



DCACP = 1B8 



A keyboard input 
device may accept 
a character. 



DCKMD = 1B0 



12 



13 



DCTBS 



DCTBF 



A keyboard input 
device is in echo 
mode. Echo the 
input character. 



The size of the device buffer (in bytes for 
character devices, in words for full word 
devices). Must be assembled into the table. 

Buffer first byte (word) address. If assembled 
as -I, then DSOS will allocate a buffer area 
(using the buffer size parameter given above). 
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DEVICE CONTROL TABLE (DCT) (Continued) 



13 


DCTBF 




(Continued) 


14 


DCTBL 


15 


DCTIP 



16 



DCTOP 



and initialize botli this word and the next word on a 
. SYSI. If other than -1, this word is assumed to be 
the appropriate beginning buffer address. 

Buffer last byte (word) address. 

Buffer current input pointer. For an output device, 
this is the byte address at which to store the next 
byte sent to the device from the user program. For 
an input device, this is the byte address at which to 
store the next byte received from the device. This 
word is maintained by the global DSOS subroutines. 

Buffer current output pointer. For an output 
device, this is the byte address from which to 
fetch the next byte for output. For an input 
device, this is the byte address from which to fetch 
the next byte requested by the user program. This 
word is maintained by the global DSOS 
subroutines. 



17 



DCTCN 



20 



DCTTO 
DCTCC 



Count of active data in the buffer, i. e. , bytes not 
yet sent to the device or bytes not yet moved to the 
user program, for output and input devices respectively. 
This word is maintained by the global DSOS subroutines. 

Timeout constant (all input devices). 
Column counter (all output devices). 
For input devices this word represents the maximum 
time interval during which they may have outstanding 
data following a start pulse. The parameter "SCTIM" 
defined on the DOS User Parameter Tape corresponds 
to a time of 1 millisecond on the Supernova SC. 
Then, if a device requires 6 milliseconds to timeout, 
the word can be assembled as: 



6*SCTIM 

For output devices, this word is maintained by the 
global DSOS subroutines. 
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DEVICE CONTROL TABLE (DOT) (Continued) 

21 DCTRC Restart constant (all input devices). 

DCTLC Line counter (all output devices). 

For input devices, if the active data count is 
less than this constant, another start pulse 
should be sent to the device. This word must 
be assembled into the table. For output 
devices, this word is maintained by the global 



r>c/^c> 1 A.: 

s^j\jo oujjujuLiiies. 



22 DCTS0 Interrupt frame pointer. This word points 

to a 7 -word block of memory in which the 
machine state is saved whenever an interrupt 
from ti'iis device is serviced. This word is 
initialized by a . SYSI. 



23 DCTSl 



Spare word. Not currently used in DSOS. 



DCT displacements 6-21 (DCTDT - DCTRC) are not referenced by Level 1 devices, 
with the exception of DCTFL, bit 15, which must be off to perform a DSOS reset 
command. For Level 2 devices, the Dispatch Table (DCTDT) must be defined. 
Use of the remaining elements depends on the definitions of this table; if any of the 
global DSOS routines are invoked then any or all of these elements may be 
referenced. 

DEVICE PRIORITY TABLE 

This table is referenced by the DSOS initialization routine (. SYSI) in order to 
establish the Device Control Table link words (DCTLK). The order in which the 
DCT's are linked determines the order in which the DSOS devices are searched 
for a matching code on an interrupt. This table is normally embedded in the 
DSOS main program. If the external normal .OPPP in the DSOS main program is 
resolved, however, then a user supplied table is used to establish the links. The 
DSOS main program table is set up as follows: 

.PTRP 
. CDRP 
.TTRP 
.PTPP 
.LPTP 
.PLTP 
.TTOP 


Each of the symbols ending in "P" is declared an entry in the DSOS main program. 
The table is always terminated with a zero word. This table reflects a descending 
priority level of the DSOS devices, starting with the $PTR and ending with $TTO. 
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DEVICE PRIORITY TABLE (Continued) 

As an example of a user supplied table, consider the addition of devices XXX and YYY, 
where XXX should be the highest priority device and YYY has a priority less than the 
$CDR but higher than the $TTR. The critical program declarations to achieve this 
priority scheme would appear as follows: 



.ENT 



.OPPP 



,NREL 
.EXTN 



,PTRP, .CDRP, .TTRP, .PTPP, . LPTP, . PLTP, . TTOP 



OPPP: 



.XXXP 
.PTRP 
.CDRP 
.YYYP 
.TTRP 
.PTPP 
.LPTP 
.PLTP 
.TTOP 




. XXXP: XXXDC 
. YYYP: YYYDC 



;POINTER TO XXX DCT 
;POINTER TO YYY DCT 



This table must be defined for Level 1 and Level 2 SOS devices. 

CHANNEL NUMBER TO DEVICE MAP 

This table is referenced by the DSOS command dispatch routine. If a DSOS I/O command 
has referenced a channel number outside of the legal DSOS .range and the "DS OS external 
normal, . OPTP has been resolved, then this table is expected to point to a list of 
Device Control Table addresses. These addresses must be ordered by channel number, 
beginning at channel number 20 (HCHNO + 1 from the DSOS parameters). Thus if 
devices XXX and YYY were being incorporated into DSOS for Level 2 compatibility 
and XXX were assigned to channel 20 and YYY to channel 21, the critical program 
declarations for this table would be as follows: 
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CHANNEL NUMBER TO DEVICE MAP (Continued) 
ENT . OPTP 



> OPTP: 
. XXXP : 
. YYYP: 



NREL 
+1 

XXXDC 
YYYDC 



;POINTER TO XXX DC T 
;POINTER TO YYY DCT 



This table must be supplied for Level 2 compatibility. The table is expandable from 

channpl nnmhpr "HrHKirVi-l " ^rv TinmKa^ nf- 



DSOS INTERRUPT HANDLING 

When an interrupt is taken, a DSOS module preserves the interrupted machine state. The 
interrupt frame pointer, DCTS0, is utilized in these procedures and when the device 
interrupt handler gains control, the "save" is complete and the mask in the device's 
Control Table (DCTMS) is active. The following functions are the responsibility of 
the interrupt routine (DCTIS): 



1. 
2. 
3. 
4. 



Clearing the done flip-flop in the device. 

Storing/ retrieving the next character in the device buffer. 

Restarting the device when appropriate. 

Returning to the DSOS Interrupt module. 



The DSOS stack mechanism may not be invoked at interrupt processing time. The DSOS 
modules . IBUF and . OBUF may be called, however, since they do not require a 
stack frame (see DSOS global subroutines). 

Two simple interrupt routines, one for output device $PTP and one for input device 
$PTR, illustrate the above points: 



PTRS: 



ADRIB: 



DIAC 


1,PTR 


JSR 


@ADRIB 


JMP 


• 


NIOS 


PTR 


JMP 


@.+l 


.EXTN 


.DISM 


.DISM 




.EXTN 


.IBUF 


.IBUF 





RETRIEVE CHARACTER/CLEAR DONE. 
STORE THE CHARACTER IN THE DEVICE'S BUFFER. 
AN IMPOSSIBLE RETURN-BUFFER ALREADY FULL. 
RESTART THE $PTR; THE BUFFER IS NOT FULL YET. 
DON'T RESTART $PTR; THE BUFFER BECAME FULL. 

;RETURN TO THE liSOS INTERRUPT MODULE. 
; ENTRY POINT 
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DSOS INTERRUPT HANDLING (Continued) 



FTPS: 


NIOC 


PTP 




JSR 


@ADROB 




DOAS 


1,PTP 




JMP 


@.+l 




.DISM 






.EXTN 


.OBUF 


ADROB: 


.OBUF 





CLEAR DONE. 

RETRIEVE THE NEXT CHARACTER 

FROM THE DEVICE'S BUFFER. 

RESTART THE DEVICE AND SEND 

THIS CHARACTER IF THE RETURN CAME 

HERE. 

OTHERWISE DON'T RESTART. 

RETURN TO THE DSOS INTERRUPT 

MODULE . 

; ENTRY POINT. 



DEVICE START, STOP. AND DISPATCH ROUTINES 
Device Start Routine 

The address of this routine is at displacement DCTST in the DCT. For output 
devices, this routine should send a start pulse plus the character from ACl. If the 
device will not interrupt as a result of this action, return to one location beyond the 

«^-r-,-v,ol -.-ct-iiv-n ^r\i^ai-\r\n Ptfrhia -t-\iri c(2 T-pfiiTTi to thp nnrmfll Inratinn. ACS nointS tO the 

normal return location. As an illustration, consider the line printer start routine: 

LPTST: DOAS 1, LPT ;START LPT, OUTPUT THE CHARACTER. 

WILL IT INTERRUPT? 
YES 
NO 

For input devices, this routine should send a start pulse and return to the normal 
return location. For example, the $PTR start routine is: 



DOAS 


1,LPT 


SKPBZ 


LPT 


JMP 


0.3 


JMP 


1,3 



PTRST: 



NIOS 
JMP 



PTR ;SEND START PULSE 

0, 3 ;RETURN 



Device Stop Routine 

The address of this routine is at displacement DCTSP in the DCT. This routine 
should simply send a clear pulse and return to the normal return location. Using the 
$PTR as an example: 



PTRSP: 



NIOC 
JMP 



PTR ;SEND CLEAR PULSE 

0,3 ; RETURN 
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Device Dispatch Routines 

The device dispatch table address is at displacement DCTDT in the DCT, previously 
described. If the global DSOS subroutines are not invoked for any of the four functions, 
then the following points should be noted in the dispatch routine: 

1. ACS points to the error return location. Increment by one for a success 
return. 

2. The contents of the user accumulators are as follows: 

AC0 - page zero displacement, "CAC0". 

■^Cl - page zero displacement, "CACl". 

AC2 - UST displacement, "USTA2". 

If an accumulator is being returned to the user, then the appropriate 
location must be changed. 

3. AC2 points to the DCT when the dispatch routine gains control. 

If the global DSOS routines are used, then they may be invoked directly (by assembling 
their addresses into the dispatch table. ) 

DSOS LINKAGE 

A simple stack mechanism is employed in DSOS at the non -interrupt level. This mech- 
anism provides a means of saving the calling routine's accumulators and of operating 
on variables stored in the stack. No stack mechanism is provided for interrupt 
processing, but the state of the current stack must be preserved whenever an interrupt 
is processed. The DSOS interrupt dispatch routine performs this service. 

TTie linkage scheme used in DSOS makes use of several page zero locations and of a 
fixed block of core assembled into the DSOS module. The size of this core block permits 
a depth of six calls from the common DSOS entry point at the start of the program. 
The page zero locations and equivalences that are used in the linkage mechanism 
include: 

SAVE - (JSR @3) invokes the routine which saves accumulators and updates 

the stack pointer. 
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DSOS LINKAGE (Continued) 



RTRN 



CSP 



RLOC 



(JMP@4) invokes the routine which restores the caller's 
accumulators and returns to him. 

(Page Zero Location) always points to the stack frame 
currently in use. 

(Page Zero Location) used as a temporary by the SAVE 
routines; may also be used as a temporary by any routine 
in lieu of allocating a stack frame. 



The stack frame is a fixed size with the following displacements defined: 



RTLOC 

AC0 

ACl 

TMP 

OAC0 

OACl 

OTMP 

ORTN 



The return location in the current subroutine (location 
which it last "called". ) 

Contents of accumulator of current subroutine at the last 
call which it made. 

Same as above; accumulator 1. 

Available for use by the current subroutine as a temporary. 

Contents of caller's accumulator 0. 

Contents of caller's accumulator 1. 

Caller's temporary. 

Caller's return location. 



Following a SAVE or a RTRN, ACS always points to the current stack frame, and 
each of the above locations may be referenced as displacements from it. Otherwise, 
the CSP may be loaded into an index accumulator in order to reference the locations. 
(Accumulator 2 is never saved since it usually contains a Device Control Table 
address and is passed as an argument from subroutine to subroutine. ) 

The typical procedures executed in using the mechanism are as follows: 

1. A routine (B) is called by another routine (A) through the JSR instruction: 

JSR B 

or 
JSR @ADDRB 



ADDRB: B 
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DSOS LINKAGE (Continued) 

2. Routine B saves the caller's return location when it begins execution with: 

STA 3,@CSP 

3. Routine B may anytime thereafter perform a: 

SAVE 

to save the caller's accumulators, allocate a stack frame, and 
Update the CSP appropriately. 



4. To return to A, routine B simply performs a: 
RTRN 

If no frame is required by B, it may save the caller's return location in RLOC: 
STA 3, RLOC 

It may then use any accumulator and operate on A's frame (by loading CSP into an 
index accumulator) if it wishes. It should perform the return in the following 
manner: 

LDA 3, CSP 

JMP @RLOC 

so that when A regains control, accumulator 3 is pointing to its frame. Note that the 
accumulators upon this return are exactly as they were left by routine B, rather than 
as they were when A called ti. 

GENERALIZED DSOS SUBROUTINES 

The global routines defined as entries in the DSOS main program, SOS, are as follows: 



.OPN 


Open 


.CLS 


Close 


. WRSE - 


Write sequential 


. WRLI 


Write line 


. RDSE 


Read sequential 


. RDLl 


Read Line 


. ACHR - 


Send a character 


. RCHR - 


Read a character 


.IBUF 


Input a character to buffer 


. OBUF 


Output a character from buffer 


.STB 


Store a byte 


. LDB 


Load a byte 


. DISM 


Dismiss an interrupt 
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GENERALIZED DSQS SUBROUTINES (Continued) 

These routines are available for use with any programs loaded with DSOS. The catling 
procedures and brief descriptions are given below. 



OPN 



Calling Sequence: JSR .OPN 



All references to JSR .XXX instructions, where .XXX is an 
entry point, are equivalent to the following instruction sequence. 



JSR 



@XXX 



Arguments: 



Return Sequence: 
Description: 



XXX: .XXX 

AC0 = Byte address of the file name if the device is an 
intervention device. Otherwise, AC0 is ignored. 

AC2 = Pointer to the DCT. 

Always returns to calling location +2 with the accumulators 
unchanged. 

If the device being opened is an intervention device, a prompt 
message is typed. If the device requires leader/trailer, it is 
punched. The device is always cleared (DCT stop routine) and 
the Device Control Table is initialized. 



.CLS 

Calling Sequence: 

Arguments: 

Return Sequence: 

Description: 



JSR .CLS 

AC2 = Pointer to the Device Control Table. 

Always returns to calling location +2 with the accumulators 
unchanged. 

If the device being closed requires leader/trailer, it is punched. 
When the device is no longer active, it is cleared and its Device 
Control Table is initialized. 
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.WRSE 



Calling Sequence: 
Arguments: 

Return Senuence- 

"1" ~ • 

Description: 



JSR . WRSE 



"CAC0"* 
"CACl"* 
AC2 



Beginning byte address for transfer 
Byte count for transfer 
Pointer to Device Control Table 



_, „ ^^^^^^^^ »,v^ »-<*iiiiig j.\jv,ciux<jii -r £. wiLii Liie accumulators 

unchanged. 

The specified number of bytes are inserted mto the device's buffer 
for output. 



.WRLI 

Calling Sequence: 

Arguments: 

Return Sequence: 



Description: 



JSR . WRLI 

CAC0 = Beginning byte address for the transfer. 
AC2 = Pointer to the Device Control Table. 

The accumulators are unchanged, except CACl which contains the 
ww,^.,, v^j. *^j,vs-o vviiLLtii, n. xcuuiii uu tiie calling location + l 
indicates the maximum line length was exceeded A return to 
calling location + 2 is normal. 

The specified ASCII characters are inserted into the device's 
buffer for output. The character string that is output is terminated 
by: 

1. carriage return 

2. form feed 

3. null byte 

Line editing is done based on the characteristics of the device. 



Page zero displacements from the DSOS parameter tape. 
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.ROSE 

Calling Sequence: 

Arguments: 

Return Sequence: 



Description: 



JSR 

CAC0 
CACI 
AC2 



ROSE 



Beginning byte address for the transfer 
Byte count for transfer 
Pointer to Device Control Table 



A return to calling location + 1 indicates either end of file or 
illegal command for device. A return to calling location + 2 
is normal. The accumulators are unchanged. CACI contains 
the partial count read on an EOF return. 

The specified number of bytes are placed in the user area from 
the device's buffer. 



.RDLI 

Calling Sequence: 

Arguments: 

Return Sequence: 



Description: 



JSR 



.RDLI 



CAC0: = Beginning byte address for the transfer. 
AC2 = Pointer to the Device Control Table. 

A return to calling location + 1 indicates either end of file, line 
length exceeded, or parity error. In this case, ACl contains 
the partial count of bytes read and CAC2*contains the error code. 
A return to calling location + 2 is normal with the accumulators 
unchanged except CACI which contains the count of characters read. 

The specified ASCII characters are inserted into the user area • 
from the device's buffer. The character string is terminated 
by: 

1. a carriage return 

2. a form feed 

Nulls, rubouts, and line feeds are ignored. 



* UST Displacement from the DOS User Parameters. 
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. KL'HR 



Calling Sequence: 
Arguments: 
Return Sequence: 



JSR 



.RCHR 



Description: 

.ACHR 

Calling Sequence: 

Arguments: 

Return Sequence: 

Description: 

. IBUF 

Calling Sequence: 

Arguments: 

Return Sequence: 



AC2 ^ Pointer to the Device Control Table. 



A return to calling location -fl indicates device timeout (end 

01 Ille). hi ihiS case, the arCllTnnlqtriri; arp> unr-hoi-irrc^H T.rii-V, «-U^ 

-. - - .^w._i_ ._i J w i^iXfc^ixtiAi^s^ vt VVJ.L11 Lilt 

error code in CAC2. A retum to calling location +2 is normal 
In this case, the right justified byte (word)* that is read is in 
ACl, with the other accumulators unchanged. 

The TK^Yl" ;l \'a i I Tl ll. > h,\rtir< it; rouH f-t-^lt-n t-ViQ Ar.^ri r-r^' ,. U,,-P4:„„ 

into ACl. It necessary, a start pulse is issued to the device. 



JSR 



ACHR 



ACl - Right ju.^tified byte to be sent 

AC2 =^ Poiiuer to the Device Control Table. 

A return is always made to calHng location +1 with the accumu- 
lators unchanged. 

The byte is inserted into the device's buffer for output. If 

necessary, a start nu'se is issued to the H^vfr^^. 



JSR 



IBUF 



ACl = Right justified byte to be inserted into buffer, 
AC2 =■• Pointer to iX: vice Control 7'able. 

A return to the calling location +1 indicates the buffer is already 
full. A return to calling location +2 mdicates the character was 
inserted and the buffer is not full. A return to calling location 
+3 indicate- the character was inserted and the buffer became 
full. In every case, the accumulators are unchanged, except 
AC0 which is destroved. 



Input devices with the characteristic, DCFWD, always operate on words rather than 
bytes. 
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IBLIF (Continued) 



Description: 



The byte (word) is placed Jni;(j tlic appropriate buffer slot and 
the Device Control Table is updated accordingly. This routine 
is used at the interrupt processing level by input devices and at 
the non -interrupt level by ouput devices. 



OBUF 



Calling Sequence: JSR 



OBUF 



ArgTiinents: 
Return Sequence: 



Description: 



AC2 



'ointer to Device Control Table 



A return to calling location + 1 indicates the buffer is empty. 
A return to calling location + 2 indicates the buffer is not empty. 
In this case, the next available byte (word) is fetched from the 
buffer and returned right justified in ACl. In both cases AC0 
is destroyed and the other acciniiulators are unchanged. 

The byte (word) is fetched from the appropriate buffer slot 
into ACl and the f^evice Control Table is updated accordingly. 
This routine is used at the interrupt processing level by output 
devices (to fetch their next bvlc for output) and at the 
non-interrupt level by input devices (to retrieve bytes from their 
buffers. ) 



. STB 

Calling Sequence: 

Arguments: 

Remrn Sequence: 
Description: 



JSR 

AC0 
ACl 



STB 



Destination byte- address. 
Right justified byte. 



The retum is always made to calling location + 1 with AC0 
incremented and the other accumulators unchanged. 

The passed byte is stored at the specified address. 
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.LDB 

Calling Sequence: 

Arguments: 

Return Sequence: 

Description: 



JSR 
AC0 



.LDB 



Source byte address 



The return is always made to calling location + 1 with the right 
justified byte in ACl. The other accumulators are unchai^d. 

The byte at the specified address is loaded and returned in 
ACL 



Calling Sequence: 
Arguments: 
Return Sequence: 
Description: 



JMP . DISM 

None. 

No return. 

This routine restores the machine to the state it was in before 
the device interrupted. Control is passed to this point when the 
interrupt from the device has been serviced. 
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1 SUS PARAMETERS 
I 

f LINKAGE 

.DUSR SAVE* JSR #3 

,DUSR RTRNi JMP #4 

.DUSR RTLOC- 19 

•DUSR AC0« 1 

,OUSR AClB 2 

.DUSR TMPi 3 

,DUSR SLGT« ThP*l 

,OUSR OAC0I ACe»SLGT 

,DUSR OACl* ACI-5LGT 

.DUSR OTHP* TMP-5LGT 

.DUSR ORTN» RTLOC-SLGT 

.DUSR NFRAMi 6. 

•DUSR SSZb NFRAM*SLGT 

I PACE ZERO 

.DUSR RLOCi 6 

,OUSR CMSK" 7 

,0U5R CSP« 10 

.DUSR COCT* 12 UN SERVICE OCT 

.DUSR BOCTi 13 {BEGINNING OF nCT CHAIN 

.QUSR CACeiB 14 

.DUSR CAC1« 15 

f INTERRUPT FRAME TEMPLATE 

.DUSR lACtS* 

.DUSR lACls 1 

.OUSR IAC25 2 

.UUSN IAL«)B 3 

.DU5R IPC* 4 

,OUSR IRLOC« 5 

.OUSR IMSK« 6 

.UUSR IFRL« 7 IINTERRUPT FRAME LENGTH 
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} DtVlCE CONTROL TABLE (DCTJ LAYOUT 
I COMhON TO ALL DEVICES 



.OUSR DCTCO* H 
.OUSR OCTMSb I 



I DEVICE CODE 

I MASK OF LOWER PRIORITY DEVICES 



IDEFINE THE MASK BITS 



.OUSR 

.DUSR 

nii«B 

,OUSR 
.DUSR 

• DUSK 

• UUSR 
.DUSR 

.DUSR DCTCH* 
.DUSR DCTLK* 

•DUSR DCTIS* 
.DUSR DCTIL* 



MSTTOs 
MSTTI« 

UCOTD _ 

11 wr I r ■ 

MSLPT- 
MSCOR> 
MSPLT* 
MSMTA" 
MSPTR" 

2 
3 

4 
5 



1B15 
1B14 

« n « « 

1B12 

1810 
1B12 
1B10 
IBU 

I DEVICE CHARACTERISTICS 
I LINK TO NEXT OCT 

I C*i terhnates The CHAIN) 

; INTERRUPT SERVICE ROUTINE ADDRESS 
1 INTERRUPT MACHINE STATE LINK 



.DUSR DCTUT* 6 

,OUSR DCTSTi 7 

•OUSR OCTSPa le 

.DUSR DCTFL* II 



I COMMAND DISPATCH TABLE ADDRESS WORD 

t ADDRESS OF DEVICE START ROUTINE 

I ADDRESS OF DEVICE STOP ROUTINE 

1 FLAGS (ACTIVE, ATTACHED, ETC.) 



I DEFINE THE FLAGS 
.DUSR DCACT" 1B15 
.DUSR OCACPT* IBS 
.DUSR DCKMD* 1B0 



; ACTIVE FLAG 

t ACCEPT CHARACTER FLAG 

t TTY KEYBOARD MODE FLAG 



t CMMON TO DEDICATED DEVICES (I.E. SINGLE USER/SINGLE BUFFER) 



.DUSR 


OCTBS- 


12 


.DUSR 


OCTBF- 


13 


.DUSR 


DCTBL" 


14 


.OUSR 


DCTIPi 


15 


.0U8R 


DCTOPi 


16 


.DUSR 


DCTCN* 


17 


• DUSR 


DCTTO« 


20 


.DUSR 


DCTCC» 


20 


• OUSR 


DCTRC* 


21 


• DUSR 


DCTLC" 


21 


• OUSR 


OCTS0« 


22 


• DUSR 


DCTS1> 


23 


.OUSR 


lchno* 


6 


.OUSR 


HCHNOs 


17 



I BUFFER SIZE ( BYTES ) 

I BUFFER FIRST ADORES (BYTE ) 

I BUFFER LAST ADDRESS 

f BUFFER INPUT POINTER (BYTE ) 

I BUFFER OUTPU POINTER 

I COUNT OF ACTIVE DATA 

I TIMEOUT WORD (ALL INPUT DEVICES) 

I COLUMN COUTER (ALLOUTPUT DEVICES) 

I RESTART CONSTANT (ALL INPUT DEVICES) 

I LINE COUNTER (ALL OUTPUT DEVICES) 

I DEVICE SPECIAL WORD 

1 DEVICE SPECIAL WORD 1 

I LOWEST LEGAL CHANNEL # 

I HIGHEST LEGAL CHANNEL H 

1 NOTE - ONE OR BOTH OF THESE EUUI- 

» VALENCES MAY BE CHANGED TO ADD 

I DEVICE DRIVERS 
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DOS USER PARAMETERS 



1 DEFINE THE SYSTEH STACK DISPLACEMENTS 



.OUSR 


SSLGT* 


-7 


,DUSR 


SSOSPi 


-6 


• DUSR 


SSRTNi 


-6 


,DUSR 


SSEAOb 


-4 


.DUSR 


SSCRY" 


-3 


.OIJSR 


SSAC0B 


-2 


,DUSR 


SSAClB 


-1 


.OUSR 


SSAC2B 


e 



I VARIABLE LENGTH OF CALLING'S FRAME 

t PREVIOUS STACK POINTER 

; RETURN ADDRESS OP CALLING PROGRAM 

I ENTRY ADDRESS OF CALLED ROUTINE 

I CARRY 

? SAVE STORAGE FOR CALLING'S ACCUMULATOR 

I (DON'T MODIFY THIS DISPLACEMENT! i ) 
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1 UFT 

t 


ENTRY 


.DUSR 


UFTFN«M 


.OUSR 


UFTEX-5 


.DUSR 


UFTAT-6 


.DU8R 


UFTeK»7 


.OUSR 


UFTBC«1« 


• DUSR 


UFTAOill 


.DUSR 


UFTDLal2 


.DUSR 


UFTDC-13 


• DUSR 


UFTUNB14 


.DUSR 


UFTCAB15 


.DUSR 


UFTC8«16 


.OUSR 


UFTSTB17 


.OUSR 


UFTisAi2Pi 


.DUSR 


UFTLA-21 


rM 1 c D 


UFTDR«22 


• OUSR 


UFTFAB23 


.DUSR 


UFTBNB24 


.DUSR 


UFTBP-25 


.OUSR 


UFTCH«26 



iFlue NAME 

fextension 
;file attributes 
^number of last block in 
^number of bytes in last 
^device address of first 

IDCT LINK 



FILE 

BLOCK 

BLOCK 



C0 UNAS8I 



IDCT ADDRESS 

llllyiTT MilMCIffD 

ICURRENT BLOCK ADDRESS 
^CURRENT BLOCK NUMBER 
;FILE STATUS 
INEXT BLOCK ADDRESS 
ILAST BLOCK ADDRESS 
fSYS.DR DCB ADDRESS 
IFIRST ADDRESS 

/CURRENT FILE BLOCK NUMBER 
/CURRENT FILE BLOCK BYTE POINTER 
/DEVICE CHARACTERISTICS 
/(LEAVE "UFTCH" AS LAST WORDl) 



.OUSR UFTEL"UFTCH-UFTFN+1 
.DUSR UFOEL-UFTOL-UFTFN+1 

/ 

/ SYSTEM FILE ENTRY 
/ 



/UFT ENTRY LENGTH 
/UFO ENTRY LENGTH 



.DUSR SFKEY««5 

. nilftD QPI It m-JI 
«wv*.p>< ^r t r\ ■ ■■ «i 

.DUSR SFNXa«3 

.DUSR SF3KII-2 

.DUSR SPBCa-1 

•OUSR SFDC8»a 



/KEY 

/HAP. OR LINK C-i IF NOT 08K OVC) 

/NEXT ENTRY IN CHAIN 

/NUMBER OF LAST BLOCK IN PILE 

/BYTE IN LAST BLOCK 

/DCS ENTRY 



'2H!! U°?AT"UFTAT-UFTDC /NEGATIVE OISP, TO ATTRIBUTES 

.OUSR UOBAD.UFTAD-UFTDC INEGAVIE DISP. TO FIRST ADDRESS 

.OUSR UOBBK.UFTBK-UFTOC /NEGATIVE OISP. TO LAST BLOCK 

.OUSR UDBBN.UFTBN-UFTOC /POSITIVE DISP. TO CURRENT BLOCK 

; 

/ FILE ATTRIBUTES 



.DUSR 
• DUSR 
.DUSR 
.DUSR 
.OUSR 



ATRP«160 

ATCHABlBl 

AT8AVB1B2 

ATPER«lbU 

ATWPB1915 



/READ PROTECTED 

/CHANGE ATTRIBUTE PROTECTED 

/SAVED FILE 

/PERMANENT FILE 

/WRITE PROTECTED 
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I 

I FILE STATUS 
t 

,0U8R STER-1815 ItRROR DETECTED 

,OUSR STI0PB1B14 II/O IN PROGRESS 

,DUSR STPwR«lBt3 IFIRST >JRITE FLAG 

,DUSR STINI-IBI INO INIT BIT 
,DUSR STCHKiiea ISET ■ READ (FILI03 

iCINIT/RELEASe SWTCH FOR 8Y5.DR DCBJ 

f 

I BUFFER STATUS 
» 

.OUSR QTM0D-1B15 fHAS BEEN MODIFIED 

.OUSR QTER-IBU fERROR DETECTED 

.DUSR QTlOP«lt^l2 11/0 IN PROGRESS 

.DUSR OTUCK-IBU IBUFFER LOCKED 

.DUSR QTCM0«181B ICOMMAND - I - READ, • KRITE 

.OUSR QTEM0HFJ9 lERROR MODE (MAG TAPE) 

.OUSR QTIN0«IB8 fINDlRECT DRIVER MODE SW, 



I 

1 SYSTEM CONSTANTS. 
» 

.OUSR SCWPB-2S5, DWORDS PER BLOCK 

.DUSR SCLLG>132. |MAX LINE LENGTH 

.OUSR SCAMX«P4. IHAX ARGUMENT LENGTH IN BYTES 

.DUSR SCFNL^UFTEX-UFTFN+l rFILE NAME LENGTH 

.OUSR SCM£R«lf^. fMAX ERROR RETRY COUNT 

.DUSR SCST««16 ISAVE FILE STARTING ADDRESS 

.DUSR SCTIMB»b0. ;RINGI0 I MS, LOOP TIME (SNJ 

.OUSR SCSYS«1 IDEVICE ADDRESS FOR SYS.DR 

.DUSR SCMAPii? IDEVICE ADDRESS FOR MAP.DIR 

.OUSR SCSVS«SCMAP*1 14 CONTIGUOUS BLOCKS FOR CORE IMAGES 

.DUSR SCSNfQB4 INUM8ER OF LEVELS 

.OUSR SCFXT«UFTEX-urTFN JEXTENSION OFFSET IN NAME AREA 

.OUSR SCRRL-64, »WOROS PER RANDOM RECORD 

.OUSR sFiNTiiea iinterrupt flag 

.DUSR SFCKD«1813 ICRITICAL READ ERROR 

.DUSR SFPRD«IB14 IPANIC ON READ ERROR 

.OUSR SFBRKtlBlS IBREAK FLAG 

.OUSR CAD2«4i? rCA LOCATION IN BOOTSTRAP 

.OUSR LADZ"CA0Z+1 »LA LOCATION IN BOOTSTRAP 
.OUSR SCFUL"LADZ*1 
.DUSR SCPARiSCFUL+l 
.DUSR SCKEY«SCPAR+l 
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f DEFINE THE EXCEPTIONAL STATUS COOES 



,DUSR 


erfno* 





.OOSR 


IwFnHb 


I 


.OUSR 


ERICM« 


2 


.DU5R 


E»*ICD« 


3 


.OUSH 


ERSVlB 


4 


,DUSR 


ERWRtJa 


5 


,DUS*? 


EREuFs 


6 


.DUSR 


ERRpRs 


7 


,OUSR 


ERuipRB 


!(?> 


.DUSR 


ERCWE* 


11 


,DUSR 


ERULEb 


12 


.OUSR 


eROEl. 


13 


.OUSR 


ERCHAb 


14 


.DUSR 


ERFDPb 


15 


,OUSR 


ERUFTb 


21 


a V w wK 


ERULI- 


22 


.DUSR 


ERRTNb 


23 


.DUSR 


ERPAR* 


24 


.DUSR 


ERCm3b 


25 


.OUSR 


ERMEMb 


26 


.DUSR 


ERSPC" 


27 


.DUSR 


ERFIL- 


3« 


.DUSR 


ERSEL* 


31 


.DUSR 


ERADRb 


32 


.OUSR 


ERRD« 


33 


.DUSR 


EROIRb 


35 


.OUSR 


ERONMb 


36 



t 
f 
t 
f 
; 
I 

t 
1 

I 
t 
f 
I 
I 
f 

; 
I 
I 
I 
f 
1 
I 
; 
I 
I 
t 



ILLEGAL CHANNEL NUMBER 
ILLEGAL FILE f^AME 
ILLEGAL SYSTEM COMMAND 
ILLEGAL COMMAMD FOR DEVICE 
NOT A SAVED FILE 
ATTEMPT TO WRITE 






AN EXISTENT Frit 



r AUt 



ATTEMPT TO READ A READ PRDTECTFO ULE 

WRITE PROTECTED FILE 

ATTEMPT TO CREATE AN EXISTPnT FTl f- 

A NON-EXISTENT FILE 

ATTEMPT TO ALTER A PERMANENT Flufe" 

ATTRIBUTES PROTECTED 

FILE NOT OPENED 

ATTEMPT TO USE A UFT ALREADY IN USE 

LINE LIHIT txCEEOEO 

ATTEMPT TO RESTORE A NON-EXISTENT IMAG 

PARITY ERROR ON READ LINE 

TRYING TO PUSH TOO MANY LEVELS 

NOT ENUF MEMORY AVAILABLE 

OUT OF FILE SPACE 

FILE READ ERROR 

UNIT NOT PROPERLY SELECTED 

ILLEGAL STARTING ADDRESS 

ATTEMPT TO READ INTO SYSTEM AREA 

FILES SPECIFIED ON DIFF. DIRECTORIES 

ILLEGAL DEVICE NAME 
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I CLI PRROR CODES 



.OUSR 
.OUSR 
.OUSR 
,OUS« 
.DUSR 
,DUSR 
.DUSR 
,OUSR 
.DUSR 
.UUSR 
.OUSR 
.OUSR 



CNEARilt??! 
CILAT«H51 
CNDbO«lg!2 
CNCT0«1H3 
CNSADI104 
CCKERB105 
CNSFSH06 
CNACM1112I7 
CILBKBlia 
CSP£R«111 
CPHeR«ii2 
CTMARB113 



I DEFINE THE PANICS 



.DUSR 
.DUSR 



PNOPi 
POFFSb 






>NOT ENOUGH ARGUMENTS 

IILLEGAL ATTRIBUTE 

INO DEBUG ADDRESS 

|N0 CONTINUATION ADDRESS 

INO STARTING ADDRESS 

ICHECKSUM ERROR 

INO SOURCE FILE SPECIFIED 

INQT A COMMAND 

IILLEGAL BLOCK TYPE 

INO FILES MATCH SPECIFIER 

IPHASE ERROR 

ITOQ MANY ARGUMENTS 



NOP MAGIC 
OFFSET 



.DUSR PKCUI" 21*P0FFS*PN0P 

.DUSR PNCSO- 22*P0pFS+PNaP 

.DUSR PNCDW" 23*P0FFS*PN0P 

.DUSR PnCDR" 24*P0FFS*PN0P 

.OUSR PNCOE" 25*P0FFS*PN0P 

.DUSR PNCRRb 26*P0FFS*PN0P 

.DUSR PNCMT" 27*P0FFS*PN0P 



; UNKNOWN INTERRUPT 

; DEVICE CODE IN AC0 

I SYSTEM STACK OVERFLOW 

t CRITICAL DISK WRITE ERRORS 

I CRITICAL DISK READ ERRORS 

I CRITICAL DISK READ/WRITE ERROR 

I RUNAWAY READER 

I MTA CONTROLER ERROR 
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I ni^FTWF TWF rWABirTFDTCTTro 

,OUSR DCCPO- itS15 f DEVICE REQUIRING LEADER/TRAILER 

,DUSR DCCGNi IBU > GRAPHICAL OUTPUT DEVICE WITHOUT TABBIN 

f HARDWARE 

,DUSR DCIDIi Jai3 I INPUT DEVICE REQUIRING OPERATOR INTERV 

.OUSR DCCnFb 1812 | OUTPUT DEVICE WITHOUT FORM FEED HARDWA 

.0U5R DCTO. iBll ; TELETYPE OUTPUT DEVICE 

.DUSR OCKEY- 1B10 ; KEYBOARD DEVICE 

,uU3R 0C'NAF« IBS I OUTPUT DEVICE REQUIRING NULLS AFTER FO 

-OUSR ncRAT« 1B0« I oijBQUTS AFTER TABS REQUIRED 

.OUSR ncPCK. IB07 I DEVICE REQUIRING PARITY CHECK 

.DUSR DCLAC- IB«6 ; REQUIRES LINE FEEDS AFTER CARRIAGE RTN 

.OUSR OCF^O* 1804 J FULL WORD DEVICE (ANYTHING GREATER THA 

.OUSR DCFFO" IB03 t FORH FEEDS ON OPEN 

.OUSR DCLTU« 1B02 f CHANGE LOWER CASE ASCII TO UPPER 

.OUSR DCC80« IB01 IREAD 9id COLUMS 

.OUSR DCDIR« IB00 t DIRECTORY DEVICE 
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I USER STATUS TABLE (UST) TEMPLATE 



,OUSR USTi 



40 



I START OF USER STATUS AREA 



,DU8R 
,DUSR 
.DUSR 
,OUSR 
,OUSR 
.DUSR 
.0U5R 
,OUSR 
.DUSR 

• DUSR 
.DUSR 
.DUSR 
.DUSR 

• OUSR 
.DUSR 

.OUSR 
.DUSR 
.DUSR 
.DUSR 
.OUSR 



USTPC* 
USTZMi 
USTSS« 
USTESi 
USTNiHn 
USTSAb 
USTDA" 
USTHU" 
USTCS" 
USTIT« 
USTBRi 
USTINi 
USTIS* 
USTWA* 
UST»S» 

USTA*ai 
USTAlJt 
USTA2B 

USTA3* 
USTCY* 





I 

2 

3 

4 

5 

6 

7 

IK 

11 

12 

13 

14 

15 

16 

23 
24 
25 
26 
27 



» PROGRAM COUNTER (LEAVE AT DISPLACEMENT 

» 2MAX 

t START OF SYMBOL TABLE 

» END OF SYMBOL TABLE 

> NMAX 

I STARTING ADDRESS 

I DEBUGGER ADDRESS 

1 HIGHEST ADDRESS USED 

I FORTRAN COMMON AREA SIZE 

I INTF.RRUPT ADDRESS 

f BREAK ADDRESS 

I INITIAL START OF NREL CODE 

IINTERRUPT SERVICE WORD 

f I/O WAIT RETURN 

I I/O COMPLETION RESTORE 

I DEFINE 4 SPARE WORDS 

t SAVE STORAGE FOR AC0 

t ACl 

f AC2 

I AC3 

I CARRY 



.DUSR 
.OUSR 



USTkL" 
USTeCs 



30 
1 



.DUSR MXFNObIK 

.DUSR UFPT«UST*USTEL 

.DUSR UFTEC«MXFNO 

.OUSR UFTiUFPT+UFTEC 



I ENTRY LENGTH 
I ENTRY COUNT 

JMAX NUMBER OF FILE TABLES 
UiSER FILE POINTER TABLE 
lENTRY COUNT 
lUFT'S 
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INDEX 



ACCUMULATOR 1 -2, 1 -3 
.ACHR A- 15 

ASCII I/O 1-3,1-5,1-6 
BINARY I/O 1-4,1-6,1-7 

BUFFER 

active data count A-4, B-3 
input pointer A-4, B-3 
output pointe r A- 4, B - 3 
size A-3,B-3 
starting address A-3,B-3 
status parameters B-6 

BYTE 

load a A- 17 
pointer in AC 1 -2 
read a A- 15 
store a A- 16 
write a A- 15 

CALL/SAVE/RETURN mechanism A-9 to 

A 11 

n.- LL 

CARD READER (CDR) 2-1 
CDRDR i 

CHANNEL 

assigned to device i,l-2 
high and low _ numbers B-3 
when adding devices A-6,A-7 

CHANNEL number to device map A-6 

CHARACTER 

input to buffer A- 15 
I/O commands 1-7 
output from buffer A-16 
read a A- 15 
write a A- 15 



.CLOSE 1-4 

.CLS A-12 

COLUMN counter A-4, B-3 

COMMAND 

descriptions Chapt. 1 
dispatch table A-2, A-3 
format 1-1,1-2 
list of 1-3 

DEVICE 

adding a _ driver App. A 
characteristics A-2 
control table 

definition A-1 

layout A-2 ff, B-2, B-3 
dispatch routines A-9, A-2 
flags A-3 
octal code for A-2 
priority table A- 5 
properties of_s Chapt. 2 
start routine A- 8, A-3 
stop routine A- P. A-3 
supported under E60S i 

.DISM A-1 7 



DOS 



DSOS interface i 
user parameter tape 



B-4 



DSOS 



commands Chapt. 1 

device supported (see DEVICE) 

interrupt handling A-7 

library tape i 

linkage A-9 

-MAIN program i. A- 5 

parameters B-1 

-program communication Chapt. 



I-l 



ERROR messages 1-10 

.GCHAR 1-7 

GENERALIZED DSOS subroutines A 



-Uff 



HMA 1-8, 1-9 

.IBUF A -15, A-7 

nSIITIALIZE D SOS communication 1 

INPUT/OUTPUT 
character 1-7 
commands 1 -3 to 1 -8 
data restart A-5 
generalized subroutines A -11 
line mode 1 -3 
sequential mode 1 -4 
teletype 1 -7 
timing of A -4 

INTERRUPT 

DCT priority mask A -2, A-7 

dismiss a A -17 

dispatch routine A -9 

frame 

links A-2 
pointer A-5, A-7 
template A-7, A -8 

handling A-7, A -8 

role in adding devices A-1 

service routine A-2, A-7 

.LDB A-17 



LINE 



counter A-% B-3 
mode I/O 

commands 1 -3 

subroutines A -13, A -14 



LINKAGE 

non -inte r rupt A -9 
parameters B-1 
to last interrupted device A-2 
to next priotity device A-2 

LOADING DSOS i 



LPT (line printer) 2-2 

"1 MAIN program of DSOS i, A-5 

MASK priority interrupt A-2 

.MEM 1-9 

. MEMI 1 -9 

MEMORY commands 1-8, 1-9 

NMAX 1-9, 1-8 

.OBUF A -16, A-7 

.OPEN 1-4 

.OPN A -12 

. OPPP DSOS table 

.OPTP A-6, A-7 

PAGE ZERO parameters B-1 

PARAMETER tape 
DOS user B-4 
DSOS system B-1 

. PCHAR 1 -8 

PLOTTER (PLT) 2-1 

PLTDR i 
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PRIORITY 

device level A -5 
interrupt mask A -2 

FTP (paper tape punch) 2-2, A -7 

PTR (paper tape reader) 2-2, A -7 

.RGHR A-15 

.RDL 1-5 

.RDLI A -14 

.RDS 1-7 

.ROSE A -14 

.RESET 1-5 

RESTART constant A-5, B-3 

ROUTINES, generalized DSOS A -11 

SAVE status 

on interrupt A-5, A -7 

on subroutine call A-9,A-10, A-11 

SCTIM A -4, B-6 

SEQUENTIAL MODE 
I/O commands 1 -4 
subroutines A -13, A -14 

STACK 

displacements B-4 
frame A -9 to A-11 

.STfi A -16 

. SYSI 1 -1 

SYSTEM constants (DOS) B-6 



.SYSTM 1-1 

TELETYPE 

commands 1-7, 1-8 
device properties Chapt. 2 

TIMEOUT constant A -4, B-3 

1 iJVlJlNVj UI i/ U A -^ 

TTI 2-2 

TTO 2-1 

TTP 2-1 

TTR, 2-3 

USER status table B-10 

. WRL 1 -6 

.WRLI A -13 

. WRS 1 -7 

.WRSE A -13 
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